home *** CD-ROM | disk | FTP | other *** search
/ Aminet 30 / Aminet 30 (1999)(Schatztruhe)[!][Apr 1999].iso / Aminet / util / sys / info.lha / Info / Info.doc < prev    next >
Text File  |  1999-02-21  |  8KB  |  216 lines
  1.                   Info V39.15
  2.          © 1997/98 by Stephan Rupprecht
  3.               All rights reserved.
  4.     
  5.  
  6. COPYRIGHT AND DISCLAIMER
  7.  This version of Info is copyrighted 1997-99 by Stephan Rupprecht. 
  8.  All rights reserved. This program is freeware, so no financial  
  9.  donations required. Redistribution allowed if the package is 
  10.  left unchanged except for addition of new language catalogs.   
  11.  The author is not responsible for any damage caused by the 
  12.  use or misuse of this documentation and/or the program(s) it 
  13.  describes.
  14.  
  15.  
  16. REQUIREMENTS
  17.  Any Amiga® (compatible) computer with AmigaOS® 2.x or higher.
  18.  
  19.  
  20. DESCRIPTION
  21.  Info is a replacement for the original AmigaDOS® 'info' command.
  22.  In opposite to other info commands, this version does not cause 
  23.  any deadlocks. You can select if you  want only information about
  24.  disks or volumes or even selected devices (they are printed in
  25.  alphabetical order). Another advantage is that the columns 'size'
  26.  and 'used' are printed no longer in blocks, but in KBytes, MBytes 
  27.  or even in GBytes, so  you  don't have to know how long a block
  28.  actually is on a specific device. For volumes the creation date
  29.  is printed additionally. Info uses 64bit math-functions, so you 
  30.  won`t get wrong results about the size of a drive, if you have a 
  31.  big hd of 2GBytes or more. Another feature is that info outputs 
  32.  the disktype of each volume:
  33.  
  34.    Output   File system
  35.    --------------------------------------------------------
  36.    OFS      Old File System (DOS\0)
  37.    FFS      Fast File System (DOS\1)
  38.    INT-OFS  Old File System, internal. mode
  39.    INT-FFS  Fast File System, internal. mode
  40.    DC-OFS   Old File System, fast dirs
  41.    DC-FFS   Fast File System, fast dirs
  42.    MSDOS    CrossDos/MSDos disk
  43.    CDFS     CDRom 
  44.    NO DOS   unknown system
  45.  
  46.          If you use any other filesystem, Info will show you the
  47.          4 byte filesystem identifier. Eg.: users of AmiFileSystem
  48.          will get a PFS or AFS as disktype.
  49.          Some filesystems, such as pfs2, don't return their real
  50.          identifier, so it's possible that you get a different type
  51.      than expected !
  52.          
  53.          
  54. INSTALLATION AND START 
  55.  To install Info simply doubleclick the Install icon in this 
  56.  directory. You can start Info only from shell, since it's a DOS 
  57.  command (except for the possibility to start it from Workbench 
  58.  through the menu item 'Execute Command...'). The format is 
  59.  »Info  DISKS/S,VOLS=VOLUMES/S,GOODONLY/S,BLOCKS/S,DEVICES/M«.
  60.  Each parameter is optional.If you don't give any parameter, you'll 
  61.  get full information. If you provide one or more device names (eg. df0:) 
  62.  or pattern strings (eg. dh?:) you will get only information for the 
  63.  device(s) matching the given string(s). If you invoke Info with the 
  64.  keywords VOLUMES or DISKS, you'll only get information from these 
  65.  ones. The keyword VOLS is only an abbreviation for VOLUMES.
  66.  Starting Info with GOODONLY given, will show you only information
  67.  on those drives which have a valid disk inserted. The BLOCKS option
  68.  will give you additional information such as total blocks, blocksize, ...
  69.  
  70.  Some examples for the DEVICES option:
  71.  
  72.  Info df0: dh0: Info only shows information about df0: and dh0:
  73.  Info d#?       Info shows all devices, which names begin with a 'd'
  74.  For more about patterns, take a look at the AmigaDOS manual (ch. 1-11).
  75.  
  76.  If you specify an assign instead of a device name, Info will give
  77.  you information on the assigned device (eg. C: -> DH0:).
  78.  IMPORTANT: LATEBINDING and NONBINDING assigns are not supported!
  79.  
  80.  
  81. CUSTOMIZEABLE DATE-TIME TEMPLATE
  82.  Starting with version 39.6 of Info, you can now specify your own
  83.  date-time template for the creation date of a volume. This is done
  84.  by setting the env variable 'info_datetime'.
  85.  The variable must contain a template describing the desired format for 
  86.  the date and/or the time. This is constructed just like C-language printf()
  87.  statements, except that different formatting codes are used. Just like in C,
  88.  formatting codes start with a % followed by the formatting command.
  89.  The following commands are accepted by this function:
  90.  (Description is taken from the autodocs, (C) Amiga International, Inc.)
  91.  
  92.     %a - abbreviated weekday name
  93.     %A - weekday name
  94.     %b - abbreviated month name
  95.     %B - month name
  96.     %c - same as "%a %b %d %H:%M:%S %Y"
  97.     %C - same as "%a %b %e %T %Z %Y"
  98.     %d - day number with leading 0s
  99.     %D - same as "%m/%d/%y"
  100.     %e - day number with leading spaces
  101.     %h - abbreviated month name
  102.     %H - hour using 24-hour style with leading 0s
  103.     %I - hour using 12-hour style with leading 0s
  104.     %j - julian date
  105.     %m - month number with leading 0s
  106.     %M - the number of minutes with leading 0s
  107.     %p - AM or PM strings
  108.     %q - hour using 24-hour style
  109.     %Q - hour using 12-hour style
  110.     %r - same as "%I:%M:%S %p"
  111.     %R - same as "%H:%M"
  112.     %S - number of seconds with leadings 0s
  113.     %t - insert a tab character
  114.     %T - same as "%H:%M:%S"
  115.     %U - week number, taking Sunday as first day of week
  116.     %w - weekday number
  117.     %W - week number, taking Monday as first day of week
  118.     %x - same as "%m/%d/%y"
  119.     %X - same as "%H:%M:%S"
  120.     %y - year using two digits with leading 0s
  121.     %Y - year using four digits with leading 0s   
  122.     
  123.  Example:
  124.  SetEnv info_datetime "created %x" 
  125.  Info outputs a date formated like this 'created 05/01/97'
  126.  
  127.  SetEnv info_datetime ""
  128.  Info does not print a creation date/time
  129.  
  130.  NOTE: This feature is only available under OS2.1 and higher!
  131.  After you have found your favorite template, you should
  132.  
  133.  SetENV ENVARC:info_datetime "you fav template"
  134.  
  135.  it, so that it does not get lost after a reboot! If you don`t
  136.  specify a template, Info uses the standard DOS template.
  137.  
  138.  
  139. NEW LANGUAGE CATALOGS
  140.  If you translate Info to your native language, please send me the
  141.  catalog translation file (.ct) via eMail, so that I can include it
  142.  into the archive.
  143.  You can find the catalog descriptor file in the subdir Catalogs/ !
  144.  
  145.  
  146. HISTORY
  147.  39.1  first public release
  148.  39.2  added pattern-matching, removed DEVICES/M option for this
  149.        purpose.
  150.        fixed a bug, which causes info to continue its job even
  151.        when a memory allocation failed.
  152.  39.3  devices and volumes are printed in alphabetical order now
  153.  39.4  recompiled with MaxonDEVELOP, some optimiziations
  154.  39.5  Info does no longer shorten the device designation to 5 characters.
  155.        New catalog file (french).
  156.  39.6  customizeable date-time template, new catalogs
  157.  39.7  finally I added the assign support, os3 version
  158.  39.8  re-implemented DEVICES/M option by request of a single user, polish
  159.        catalog
  160.  39.9  supports multiple assigns, now "Info Work:"-like calls are possible,
  161.        new catalogs: serbian,spanish,italian
  162.  39.10 added GOODONLY option
  163.  39.11 changed german catalog by request of a single user, fixed rounding
  164.        error
  165.  39.12 no "division by zero" guru, when disk size equals zero (thanks to
  166.        Matthew Wakeling for the bug report).
  167.  39.13 added some new dostypes (specified by the author of the great xfs)
  168.        to the internal conversion table (that thing that turns a DOS\0
  169.        into a OFS or DOS\1 into FFS, ...).
  170.        DEVICE option ignored volumes and assigns.
  171.  39.14 A single user reported me that info crashed on his v39 system when
  172.        setpatch wasn't installed. I also have v39 but not this problem!
  173.        To avoid a crash info checks if setpatch is running (it always did
  174.        it for v40 systems since there was another user who reported me this
  175.        for his v40 system). 
  176.        Info no longer assumes that the last character of a volume name is a
  177.        colon.
  178.  39.15 new BLOCKS/S option. added some new dostypes to the internal 
  179.        conversion table <Timo Ronkko>.
  180.  39.16 used buggy mathcode for info_v39 39.15 <Martin Sprenger>.        
  181.  
  182.  
  183. SPECIAL THANKS GO TO
  184.    Gunther Nikl for reporting me that the german catalog file
  185.    was missing the last time (39.1).
  186.    Jussi T Lindgren and
  187.    Dirk Mueller for their suggestions.
  188.    Jens Gerrit Schröder for the bugreport.
  189.  
  190.  Translators:
  191.    Didier Giron (french)
  192.    Kristoffer Larsson (swedisch)
  193.    Kim Roar Utsi (norwegian) 
  194.    Dimitris Panokostas (greek)
  195.    Tomasz Kepa (polish)
  196.    Javier de las Rivas and
  197.    Juan Antonio Burgos Lopez (spanish)
  198.    Daniele Peri (italian)
  199.    Ljubomir Jankovic (serbian)
  200.    
  201.    and to all others, who sent me an eMail and aren't mentioned here!
  202.  
  203.  
  204. AUTHOR
  205.  
  206. Please send bug reports and ideas to:
  207.  
  208.  Stephan Rupprecht
  209.  Apfeldweg 1
  210.  D44359 Dortmund
  211.  Germany
  212.  
  213.  Send emails to
  214.  
  215.  stephan.rupprecht@gmx.de
  216.